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HYPERTEXT  REFERENCE  SYSTEM  FUNCTIONAL  SPECIRCATION 


1.0  INTRODUCTION 


1.1  Background 

Interest  in  computerized  aidino  systems  to  assist  the  operator  of  complex 
systems  (e.g.,  process  control,  tactical  aircraft)  has  been  increasing  steadily  over  the 
last  ten  years  (Rouse,  1988).  This  trend  has  been  due  to  the  increasing  capabilities 
of  control  systems  and  complexity  of  operation.  A  type  of  automated  task  execution 
assistance,  knovm  as  adaptive  aiding,  has  been  introduced  as  a  way  to  help  the 
operator  execute  tasks  in  these  high  workload  environments. 

Adaptive  aiding  technology  --  flexible,  computerized  aiding  systems  that  adapt 
to  the  human  operator's  needs  according  to  the  current  operating  demands  -  is 
developing  in  response  to  increasing  control  and  monitoring  demands  on  the 
operator.  Recently,  the  conceptual  viability  of  adaptive  aiding  has  been 
demonstrated  (Rouse,  1988).  However,  given  the  lack  of  fielded  systems  and  only  a 
small  number  of  research  results,  a  starfdard  approach  to  aid  design  has  not  been 
established. 

Search  Technolog/s  current  effort  on  the  Adaptive  Fur^ction  Allocation  In 
Intelligent  Cockpits  (AFAIC)  program,  of  which  this  present  effort  is  a  part,  is  to 
catalogue  the  relevant  literature  from  various  disciplines  (e.g.,  human  performance, 
engineering  psychology,  systems  design,  human  factors,  etc.)  and  extract  valid 
guidelines  and  lessons  learned  from  adaptive  aiding  efforts.  The  current  undertaking 
is  an  effort  to  transform  adaptive  aid  system  research  into  the  realm  of  engineering 
design,  rather  than  allow  it  to  remain  in  a  form  only  understood  by  basic  researchers. 
In  addition,  a  supporting  goal  of  this  effort  is  to  Identify  where  necessary  basic  and 
applied  research  ought  to  be  conducted  to  fill  in  the  knowledge  required  to  produce 
useful,  reliable  adaptive  aidng  systems  in  various  operating  domains. 


1 .2  Purpose  of  this  Document 

This  document  describes  functional  specifications  for  a  computer-based 
guideline  reference  system  product  intended  to  serve  as  a  repository  for  information 
compiled  during  the  AFAIC  effort.  The  product  is  a  hypertext  database  system 
containing  literature  references,  design  guidelines  extracted  from  the  references, 
lessons  learned,  and  supporting  empirical  data  relevant  to  aiding  systems  design. 
This  product  Is  designed  to  be  a  comprehensive  reference  system  for  aiding  systems 
designers,  in  which  all  infonikation  affectir>g  an  aid  design  effort  can  be  retrieved  in  a 
complete,  logical,  and  easily  navigated  format. 

Several  core  design  documents  have  been  reviewed  to  date.  The  complete 
bibliography  of  material  to  be  contained  in  the  first  prototype  of  this  system  can  be 
found  in  the  literature  review  providing  the  initial  information  source  for  this  system 
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(see:  "Guidelines  for  Adaptive  Aid  Design  :  A  Review  of  the  Literature",  Anoskey  and 
Andes,  1991).  Primary  value  added  of  the  current  effort  is  to  arranoe  the  guidelines, 
lessons  learned,  design  implications,  and  empirical  support  into  a  format  that  would 
increase  the  likelihood  that  this  information  will  be  considered  by  the  designer  at  the 
appropriate  stage  in  the  aid  production  process. 

This  document  describes  the  Adaptive  Aiding  Design  Reference  System  in 
functional  terms.  Implementation  details  shall  be  disclosed  in  a  detailed  design 
document. 


1.3  System  User  Profiles 

There  are  several  levels  of  user  possible  for  this  system.  For  the  first 
prototype,  however,  we  will  only  focus  on  one  user  group.  This  user  profile  is 
described  in  this  section. 

The  primary  market  for  this  product  is  the  engineering  design  and  behavior^ 
science  communities  collaborating  in  the  design  of  adaptive  aiding  systems.  This  is 
a  highly  limited  market;  however,  functionality  can  be  expanded  for  other  markets  as 
design  knowledge  is  gained  and  more  aiding  systems  are  implemented.  The 
following  user  description  focuses  on  members  of  this  market  segment  only. 

1.3.1  Primary  User  Profile 

1.3. 1.1  Educational  Background 

Professionals  who  we  expect  to  be  primary  users  play  a  significant  role  in 
both  top-level  aiding  systems  design  and  generation  of  empirical  results  influendng 
the  top-level  designs.  As  such,  we  expect  that  these  professionals  will  have  attained 
at  least  a  Master  of  Science  Degree  in  either  behavioral  sdence  or  an  engineering 
discipline.  Perhaps  up  to  50%  of  the  users  will  also  hold  PhD  degrees.  Basic 
knowledge  of  computers  is  assumed,  given  the  feature  of  the  technology. 

The  possible  range  of  users  suggested  in  the  previous  paragraph  suggests 
that  users  will  be  generally  familiar  with  all  areas  relevant  to  adaptive  aiding  design 
(e.g.,  workload,  human  factors,  human  performance,  intelligent  systems),  but  not 
specifically  in  the  area  of  adaptive  aiding. 

1.3. 1.2  Knowledge  and  Skills 

It  is  anticipated  that  users  will  only  possess  moderate  familiarity  with  the 
breadth  and  focus  of  the  material  contained  within  the  product.  As  mentioned 
earlier,  it  is  anticipated  that  the  typical  user  will  most  likely  be  a  specialist  in  one  of 
the  subfields  contributing  to  the  knowledge  necessary  for  successful  implementation 
of  aiding  systems. 

That  fact  notwithstanding,  users  of  the  tool  will  need  to  know  which  guidelines 
from  other  contributing  fields  --  in  addition  to  guidelines  unknown  in  their  spedal^ 
field  "  affect  the  design  problem  at  hand.  This  knowl^e  must  be  characterized  in 
terms  that  the  user  can  understand.  Without  a  priori  knowledge  of  each  possible 
user's  backgrourd,  the  knowledge  contained  within  the  tool  mu^  assume  a  medium 
familiarity  with  engineering  terminology  and  also  be  (somewhat)  familiar  with  jargon 
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indigenous  with  human  performance  and  perception.  A  glossary  of  terms  should 
resolve  any  misunderstandir>gs  at  this  level. 

System  designers  often  consider  themselves  to  be  representatives  of  the  end- 
user  community.  Through  introspection,  personal  requirements,  and  empirical 
results,  they  make  their  design  decisions.  This  perspective  must  be  considered  in 
the  design  of  the  tool.  Design  approaches  to  implementing  specific  aid  functions  can 
be  presented  as  lists  of  alternatives,  or  rather  "^uivalent"  approaches  that  serve  as 
advice  instead  of  prescriptive  information.  In  essence,  the  knowledge  would  be 
available  as  the  oridge  from  concept  to  implementation  with  several  possible 
approaches  to  the  design  available.  In  this  way,  the  designer  can  evaluate 
artematives  without  needlessly  constraining  the  design  before  it  is  completely 
formed.  This  will  facilitate  the  creative  process  necessary  for  new  designs.  The 
approach  given  here  would  be  particularly  valuable  to  the  Highly  educated  designer 
described  in  previous  sections. 

Users  will  most  likely  possess  medium  to  high  computer  literacy.  The  literacy 
will  not  be  evenly  distributed  over  types  of  computing  or  operating  systems.  The 
majority  of  users  will  be  familiar  with  PC  environments  for  general  user  tasks  and 
applications.  Having  this  experience,  the  users  will  be  more  familiar  with  concepts 
and  operations  of  the  PC  genre  of  computing  environments. 

The  projected  user  population  will  probably  want  to  import  information 
(pertaining  to  known  guidelines  or  missing  information  relevant  to  aiding  (e.g.,  new 
empirical  results,  expansion  of  established  concepts).  In  order  to  do  this,  the 
computing  platform  and  operating  environment  must  be  familiar  to  them.  Most  of  the 
users  will  probably  not  be  regular  Macintosh  users.  However,  the  growing  number  of 
PC  based  products  with  graphical  interfaces  and  Mac-like  features  may  dissolve  the 
large  interface  and  operations  differences  between  the  two  platforms  over  a  short 
(Period  of  time. 

1.3.1. 2  User  requirements 

Projected  users  of  this  product  will  seek  information  at  two  levels: 

0  Information  and  guidelines  directly  afpplicable  to  the  design  problem 
at  hand,  and 

0  Information,  guidelines,  and  empirical  su(P|Port  for  particular  concepts 
relevant  to  design  of  state-of-the-art  aiding  systems. 

Although  at  first  these  user  requirements  appear  completely  disparate,  closer 
examination  shows  that  the  primaiy  distinction  is  one  of  information  depth.  The 
former  requirement  is  concerned  with  accepted  rules  and  practices  to  be  used  in  a 
current  design;  the  latter  is  concerned  with  the  verification  and  validation  of  these 
practices.  The  latter  is  also  concerned  with  furthering  the  state  of  the  art.  Both 
information  seeking  behaviors  should  be  considered  in  the  tool  since  the  user  will 
probably  engage  in  both  types  of  behavior  given  a  different  puqpose  for  access  to  the 
tool.  Also,  a  user  may  require  greater  depth  of  information  about  a  guideline  if  he 
questions  its  validity  in  design. 
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1.3. 1.3  Summary  User  Profile  • 

The  previous  discussion  about  user  population  yields  the  following  summafy^ 

profile: 


Educational  Background 

Level  of  education . Master  of  Sderce  or  equivalent 

Professional  specialty . Behavioral  science 

. Engineering  {system  design) 


Work  Environment 


Orgar^ation . Govemn>ent  or  aerospace  engneeririg 

Role . Member  of  techrical  staff 

Soda!  environment . Team  member 

Resource  environment . Moderate  to  extensive  corr^wtir^  resources 


Knowledge  and  Skills 

Area  specialty . One  of:  human/machine  interface  cosigner,  human 

factors,  human  performance,  systems  engneering 

Computer  Bteracy:  ,, .  • 

Hardware/software  -  general . MecSum  to  very  high  ^ 

PC -general . Medumtohigh  - 

Macintosh . Low  to  rr^ium 

Graphical  interfaces . Medum  to  high 

Hypertext  interfaces . Low  to  medium 


1.4  Implications  of  User  Profile  on  System  Requirements 

Based  on  the  Summary  User  Profile,  the  following  system  requirements 
emerge: 

1.  Information  and  guidelines  about  human  behavior  in  complex  control 

tasks  should  be  highlighted  at  engineering  (rather  than  research)  r 
level. 

2.  All  guidelines  should  have  supporting  empirical  evidence  and  related  • 
information  readily  available  with  easy  access  (where  possible). 

This  is  necessary  to  ensure  that  substantiated  guidelines  ^pplant  i 
user's  personal  opinions  and  experience  when  valid  empincally  r- 

based  guidelines  exist.  u 

3.  A  glossary  or  dictionary  should  be  provided  to  reduce  confusion  due  ^ 

to  "jargonization".  - 
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4.  The  guidelines  and  information  contained  within  the  tool  is 
augmentable  with  user's  personal,  domain,  and  problem  specific 
knowledge. 

5.  The  system  should  be  easily  expandable  with  new  research  results. 

6.  The  tool  should  support  export  of  information  for  design  reviews. 

7.  Relevant  Mil-Star>dards  should  be  included  where  applicable.  This 
tool  will  be  used  by  government  employees  arxl  aerospace 
designers  who  must  observed  applicable  standards  for  design. 
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2.0  HARDWARE  AND  SOFTWARE  REQUIREMENTS 


2.1  Reviewed  Envlronrr^nts 

The  hypertext  reference  system  should  be  developed  and  delivered  on  a 
personal  (e.g.,  PC-class  or  Macintosh)  computing  system.  This  approach  will  allow 
a  large  number  of  users  to  employ  the  system  without  requiring  mainframe  access. 
In  acfdition,  learning  a  new  system  (e.g.,  hypertext-based  reference)  will  not  involve 
learning  a  new  operating  system  as  well. 

Two  such  platforms  were  reviewed:  the  DOS-based  personal  computer,  and 
Macintosh  running  under  the  MultiRnder  operating  system.  Hypertext  development 
products  meeting  the  criteria  set  below  were  reviewed  for  each  platform.  This  is  not 
an  exhaustive  review:  The  focus  of  this  section  is  on  low-cost  hypertext 
development  tools,  rather  than  high-end  hardware  platforms  and  custom 
applications. 

The  top  two  hypertext  development  tools  on  each  platform  are  described 
below.  These  choices  are  based  on  Glushko’s  (1990)  article  entitled  "Using  Off-the- 
shelf  Software  to  Create  a  Hypertext  Electronic  Encyclopedia".  Other  information 
was  ascertained  from  programmers  possessing  programming  experience  wth 
hypertext  development  tools.  Requirements  for  the  software  product  included:  price, 
searching  and  browsing  features,  ease  of  use,  link  programming,  user  interface,  and 
programming  features  of  the  product  (some  of  the  information  is  taken  directly  from 
Glushko,  1990).  Basic  hardware  configuration  for  the  recommended  platform  is 
given  in  the  next  section. 

2.1.1  Macintosh  Hypertext  Software  Tools 

The  most  popular  hypertext  tools  fqr  the  Macintosh  environment  are 
HyperCard^  (Apple  Computer)  and  SuperCarcp  (Silicon  Beach).  They  both  exploit 
the  desktop  metaphor  interface  of  the  Macintosh,  and  as  such,  appear  to  be 
indigenous  software  systems  on  the  Mac. 

In  part,  this  is  true.  HyperCard  was  originally  packaged  with  the  Madntosh;  it 
was  further  enhanced  with  the  release  of  HyperCard  2.0.  SuperCard,  on  the  other 
hand,  was  produced  by  Silicon  Beach  Software  to  overcome  some  of  the  limitations 
of  HyperCard.  It  is  more  of  a  software  development  environmerit,  complete  with 
multiple  window  support,  programming  project  maintenance  facilities  and  better 
importing  facilities  than  HyperCard.  Both  of  these  products  are  low-cost  hypertext 
tools,  but  are  only  available  for  Macs.  They  are  reviewed  below. 

HyperCard  2.0  -  HyperCard  is  an  obje<S-oriented  programming  product  that 
allows  a  user  to  easily  translate  an  Idea  into  a  working  computer  prototype.  It  was 
the  first  widely  used  hypertext  product.  HyperCard  uses  a  "card  stack"  metaphor 
resembling  an  electronic  version  of  a  staw  of  index  cards.  Users  can  construct 
"stacks"  for  virtually  any  subject  from  address  Irxiexes  to  complex  hyper^xt 
implementations.  HyperCard  uses  (In  rever^  aggr^ation  order)  stacks  of 
cards,  buttons,  fields,  and  icons  to  Integrate  into  t^ons.  What  makes  HyperCard 
so  attractive  is  that  the  user  can  do  as  little  or  as  much  programmirig  as  de^red. 
Several  example  stacks,  buttons,  fields,  etc.  are  available  for  ^t  and  paste.  The 
hypertext  capabilities  of  HyperCard  consist  primarily  of  the  ability  to  link  cards  to 
cards,  fields  to  fields,  and  also  other  combinations  of  HyperCard  objects. 
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Built-in  visual  effects  like  dissolves,  zooms,  and  wipes  enable  a  kind  of 
animation  when  cards  are  displayed  in  rapid  sequence.  HyperCard  Is  supported  by 
an  object-oriented  programming  language  called  HyperTalk.  It  can  be  extended  by 
any  utility  that  runs  on  a  Madntosh. 

In  HyperCard,  there  are  no  limitations  on  the  number  or  size  of  units.  With 
HyperCard  2.0,  multiple  cards  can  be  displayed  at  once  (in  contrast  with  HyperCard 
1 .2)  but  links  cannot  be  made  between  all  object  types.  For  example,  scrolling  text 
cannot  contain  "hot"  (clickable)  terms,  nor  can  scrolling  text  be  linked  to  other  cards. 
This  limits  the  size  of  text  per  unit. 

HyperCard  can  also  integrate  text  and  non-textual  components.  Bit-mapped 
graphics  can  be  placed  onto  cards  easily.  Any  part  of  a  card  can  be  the  source  of  a 
link.  Selecting  a  link  can  also  enable  sound,  animation,  etc.  as  well,  giving 
HyperCard  multimedia  capabilities.  It  supports  a  limited  (and  slow)  search  fadlity, 
however  this  can  be  overcome  with  external  products.  It  provides  built-in  navigation 
via  "previous"  and  "next"  buttons  as  well  as  irxJex  and  a  graphical  representation  of 
the  most  "recent"  cards  visited.  Bookmarks,  notes,  help  etc.  can  all  be  supported. 

The  major  limitation  to  HyperCard  is  its  ability  to  handle  large  applications.  It 
is  a  complete  programming  environment  with  multi-media  suppyort,  but  requires  an 
experienced  programmer  to  customize  it  for  a  specific  application.  As  such,  "it  is  a 
superb  prototyping  tool  for  user  interfaces  and  much  less  suited  as  a  delivery 
platform  for  large  hypertexts"  (Glushko,  1990). 

SuperCard  -  SuperCard,  on  the  other  hand,  does  not  use  the  card  metaphor, 
and  anything  can  be  a  button.  SuperCard  "projects"  (series  of  files,  etc.)  contain 
windows  (scrolling  windows,  title  box,  dialog  box,  etc.)  and  windows  contain  cards. 
With  SuperCard,  the  user  is  not  limited  to  one  stack  of  cards.  A  number  of  windows 
carl  be  contained  in  each  project.  SuperCard  has  more  extensive  import  and  export 
fadiities,  in  addition  to  better  text,  window,  and  graphics  editing.  The  extensions  to 
the  HyperTalk  language  indude  a  number  of  ways  to  reference  an  object  (previously 
a  problem),  better  handling  of  resources  and  no  window  formatting  limitations.  The 
most  attractive  features  of  SuperCard  are  that  independent  Madntosh  applications 
can  be  built  (not  on  top  of  HyperCard,  etc.),  compiled,  and  run.  Editors  enable  the 
programmer  to  debug  animations,  import  and  enhance  graphics,  etc.  SuperCard 
should  be  run  on  at  least  a  Madntosh  il  (for  speed). 

2.1.2  Personal  Computer  Hypertext  Software  Tools 

Guide  -  Guide^  ^WL  Internationa!)  Is  available  as  both  a  PC/AT  version  and 
a  Madnt^h  version.  Only  the  former  is  considered  in  this  description.  Guide  is  a 
Windows^  (Microsoft)  application,  so  it  can  exploit  the  interface  and  mouse  support 
of  Windows. 

Guide  looks  like  Windows  due  to  its  interface  requirements.  The  desktop 
metaphor  of  Windows  applies  completely  to  Guide.  Articles  (or  separate  text  theme) 
are  separate  files  (limited  only  by  DOS  file  size)  and  can  contain  bit-mapped 
graphics.  Graphics  can  be  combined  and  be  "exploded"  to  provide  more  detail. 
However,  this  capability  is  of  limited  value  to  the  current  system. 

Guide’s  strong  suit  is  a  rich  set  of  link  types.  Unk  types  are  represented  by 
text  attributes,  cursor  shape,  or  by  explicit  markers  (Glushko,  1990).  Hierarchical 
disclosure,  or  replacement  of  text  with  explanation,  for  example,  is  supported. 
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Reference  links  are  supported  for  direct  access,  as  are  rwte  links  for  detail. 
Command  links  activate  a  command  hidden  in  a  definitions  window,  while  expansion 
links  allow  the  display  of  hidden  ’detail"  information  about  a  higher  level  topic.  Two 
versions  of  Guide  are  present:  one  for  authoring,  one  for  just  navigating.  It  is  a 
ample  matter  to  switch  from  one  to  the  other. 

Guide  supports  tables  of  contents,  and  hierarchical  organization  of  documents 
and  ideas.  Limited  string  search  and  full-text  search  are  available  but  are  rather 
slow.  Guide  maintains  a  stacic  of  areas  visited  and  provide  navigation  assistance  to 
the  user.  Navigation  within  Guide  is  limited  however,  bookmarks  on  documents  are 
fX)t  supported.  Nonetheless.  Guide  has  some  of  the  best  features  found  in  a  PC 
product. 

Two  programming  languages  are  available  in  Guide:  Logiix  and  OPCL3. 
OPCL3  is  designed  to  handle  general  Guide  document  handling  (e.g.,  automatic 
document  close,  auto  reformat  etc.).  Logiix,  on  the  other  hand,  is  a  more  powerful 
language.  It  allows  the  programmer  to  activate  data  exchange  between  applications, 
write  complex  scripts  (like  HyperTalk),  run  dialogue,  etc. 

One  particular  capability  of  the  current  release  of  Guide  makes  it  attractive: 
automatic  import  and  basic  in(^xing  of  dBase  files  (i.e.,  the  current  Adaptive  Aiding 
Guidelines  Database  is  in  ’.DBF  format).  This  feature  allows  the  implementor  to 
directly  import  the  work  that  has  been  completed  thus  far.  Though  a  great  deal  of 
work  must  be  conducted  to  complete  the  product.  Guide's  import  fadlity  allows  the 
team  to  build  on  complete  work  rather  than  beginning  over.  A  major  drawback  to 
Guide  is  document  access  speed.  Additionally,  a  powerful  hardware  platform  is 
necessary  for  user  acceptance. 

ToolBook  -  Toolbook^  (Asymetrix  Corp.)  is  basically  a  PC-based  version  of 
Hyper/SuperCard  (several  of  the  HyperCard  features  discussed  earlier  also  apply  to 
ToolBook).  It  too  runs  under  Windows  3.0.  ToolBook  uses  a  book  metaphor  as  its 
basis.  The  user  opens  a  ’book",  and  each  separate  segment  of  data  or  graphics  is 
contained  on  a  "page".  Tables  of  contents  are  easily  done,  as  are  simple 
navigational  aids,  very  much  like  HyperCard.  The  scripting  langu^e  available  in 
ToolBook  resembles  both  HyperTalk  and  Visual  Basic. 

Toolbook’s  strong  suits  are  its  rapid  prototyping  (like  HyperCard),  graphics 
import,  and  scripting  capabTrties.  It  also  imports  dBase  files,  but  with  limited 
functionality.  Complex  cursor  control  arxl  access  speed  are  drawbacks. 


2.2  Development  Environment 

The  following  development  and  delivery  platform  is  recommended: 
2.2.1  Recommended  Hardware 

0  Personal  Computer  386  PC  (or  1 00%  compatible) 
minimum  25  MHz  clock  speed 
0  1  MB  RAM  or  higher 

0  VGA  graphics  afepter  and  card 
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0  Standard  keyboard 
0  Microsoft  (or  equivalent)  mouse 
0  1  -  720  Kb  Roppy  Disk  Drive 

0  1-40  MB  Hard  Disk  Drive  (2.5  MB  for  hypertext  tool) 

2.2.2  Recommended  Software 
0  DOS  5.0 

0  Guide  (version  3.01 )  $495.  Requires  Windows  3.0. 

0  Windows  3.0  ($90) 


This  configuration  is  specified  for  the  following  reasons: 

1.  The  PC  platform  is  most  commonly  used  and  understood  personal 
system  in  use. 

2.  The  Wndows  desktop  metaphor  is  familiar  to  most  computer  users. 

3.  Guide  is  a  highly  flexible  development  environment  spedficaJly 
designed  for  hypertext  applications.  As  such.  It  supports  product 
development  and  has  better  programming  features.  Environment 
support  provides  many  of  the  desired  system  functions  without 
further  programming. 

4.  Guide  is  portable  to  many  other  hardware  ar>d  software  platforms 
(e.g.,  Unix  operating  system,  mini-computers,  etc.),  ft  can  interface 
directly  with  many  other  software  tools  as  well  (e.g.,  dBase,  Oracle, 
Sybase,  etc.).  We  may  desire  to  provide  direct  input  to  the  systerri 
from  on-line  databases  in  the  future. 
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3.0  SYSTEM  DATA 


3.1  Data  Types  and  Files 

Five  basic  data  types  will  be  contained  in  the  Adaptive  Aiding  Hypertext 
reference  system.  Three  types  are  primarily  design  reference  information  - 
Enhanced  Bibliographic  References,  Extracted  Design  Guidelines,  and  Materia! 
Summaries  written  from  a  design  expert’s  p>erspective.  This  information  will  initially 
be  directly  imported  from  the  database  source  files  containing  the  information  (this 
process  has  already  been  completed). 

The  last  two  types  of  information  are  system  databases  containing  navigation 
and  operational  information.  In  the  links  database,  all  of  the  object  links,  by  link  type, 
present  within  the  system  are  catalogued  for  fast  reference  and  also  used  for  system 
link  verification  when  new  material  is  added.  The  notes  database  catalogues  all  of 
the  annotations  present  in  the  system  and  also  contains  run-time  loaded,  user  added 
annotations  to  assist  in  interface  customization.  Term  definitions  are  considered 
notes  and  are  not  a  separate  data  type.  All  data  types  are  explained  in  the  following 
sections. 

3.1.1  Enhanced  Bibliographic  Reference 

The  main  objects  within  the  system  are  the  bibliographic  references  for  each 
article  included.  Standard  database  record  information  is  contained  within  each 
reference  (e.g.,  full  title,  source,  authors,  abstract,  etc.),  in  addition,  the  reference 
data  contains  information  about  the  nature  of  the  article  (i.e.,  empirical  investigation, 
concept  development,  etc.)  and  other  insightful  categorizations  that  will  be  helpful  for 
the  designer.  The  complete  record  information  is  given  below.  For  each  data  item, 
the  name,  types,  and  other  relevant  information  are  listed.  (This  is  based  on 
database  record  format  constructed  during  the  literature  review  task). 

The  following  information  is  assodated  with  each  record  in  the  bibliographic 
database: 


Data  Name 

Data  Description 

Data  Types 

ID 

Ur^ue  identification  syrrt)ol  (system 
specific 

pointer 

Title 

Full  title  of  article 

character  string  (•■  255  characters) 

Date  {xiblished 

Year 

character  string 

Ut_type 

Source  literature  type 

character  string: 

Book 

Journal  article 

Conference  proceeding 

Tech  refill 

Application  domain  of  material 

character  strir^: 

Aerospace  or  r»n-aerospace 
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Subject  type 

The  primary  theme  of  the  material 

contained  in  the  article 

character  string: 

Concept  or  architecture 
description 

Imptementation 

Empirical  investigation 

Literature  review 

Evaluation  of  system  or 
architecture 

BibIio_ref 

Full  bibliographic  refererxx  source 

character  string 

Pages 

Number  of  pages 

integer 

3.1.2  Design  Guidelines 


The  most  useful  information  within  the  reference  system  are  the  design 
guidelines  that  have  been  extracted  from  reviewed  articles,  this  information  will  be 
used  in  two  ways:  By  system  designers  with  design  problems  at  hand  and  also  for 
the  researcher  looking  to  identify  areas  where  more  research  results  are  needed  to 
provide  direction  for  the  system  designer.  As  mentioned  in  the  user  profile  section 
(1.3),  these  roles  are  often  played  by  the  same  person. 

Design  guidelines  are  presented  as  just  that:  guidance.  A  useful  guideline 
will  discuss  specific  information,  such  as  parameter  values  for  models  of  human 
performance  or  particular  contexts  in  which  aiding  should  be  employed.  A  concerted 
effort  has  been  made  to  reduce  the  number  of  general,  or  nebulous,  guidelines.  This 
is  because  of  the  tendency  of  designers  to  be  context  insensitive  in  pressure  design 
situations. 

The  guidelines  information  contains  the  guideline  text  itself,  source  of  the 
information,  and  rationale  behind  the  guideline.  Further,  they  are  categorized 
according  to  possible  design  issues  to  which  they  are  most  applicable  (this  is 
discussed  in  the  literature  review  and  indicated  in  the  table  below).  The  complete 
information  description  for  guidelines  is  given  in  the  following  table. 


Data  Name 

Data  Description 

Data  Types 

Ref.  syrrtol 

A  pointer  to  the  source  article. 

The  ’relation'  to  the  bfoSographic 
database. 

pointer 

Author_ref 

Reference  to  source  (short) 

character  strirg 

Date 

Year 

integer 

Guideline_type 

General  categorization  erf  guideline,  e.g. 
Does  it  pertain  to  prindptes  of 
interaction  or  principles  of 
adaptation? 

applicable  to  either: 
adaptation 
interaction 
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Applicable_ 

aiding 


Type  of  akJng  most  appScable  for 
this  guideBne 


Guideline 


Rationale 


Framework 

question 


Actual  gjideEne  text 


Support  text  for  guideline 


Author  reference  (paper)  for  this 
guideSne  -  cortceplually  related, 
errpirica!  support  for  gukJeSrre,  or 
(Srect  reference 

(These  are  verification  inks  for 
system  implementation) 


Second  Ir^  slot,  there  may  be  more 
than  2 


Rouse  (1988)  proposed  a  framework 
for  design  of  adaptive  akfirg 
systems.  Each  guideRne  is 
pre-ctassified  accordirrg  to  the 
primary  design  issue  that  it 
acWresses. 


chara:ler  strir^: 
aBocation 
transformation 
partitiorHng 
(furx:t)ionaI  allocation 


character  field 


Irrplication 


The  ^ideSne  pertains  to  one  of  these 
fourissjes. 


poimer 


character  drirtg: 

What  is  ada^i^ed  to? 

Who  ck>es  the  adapting? 
When  does  adaptation  occur? 
What  methods  of  adaptation 
apply? 

How  is  adaptation  done? 
What  is  the  nature  of 
commi  location? 


character  string: 


user  acceptance 
situation  assessment 


3.1.3  Lessons  Learned  and  Material  Summary 

This  information  is  the  most  subjective  in  the  system.  It  attempts  to 
summarize  lessons  learned  (or  lessons  to  be  learned)  as  a  result  of  reviewing  this 
material.  Additionally,  the  worth  of  the  material  to  designers  and  researchers  alike  is 
assessed.  The  following  information  is  contained  In  the  lessons  learned  and 
summary  data  type. 
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Data  Name 

Data  Types 

Ref.  symbol 

Pointer  to  source  article 

pointer 

Lessons 

Text  of  lessorts  teamed  in  this  articte 
(H  needed) 

character  field 

Summary 

Text  summary  of  article's  relevance 
to  adaptive  aiding  written  in  an 
evateative  manner.  This  segment  will 
also  cor^ain  the  tools  &  techniques 
information  from  the  text 
representation.  Evaluation  as 
necessary. 

character  text 

3.1.4  Link  List 


The  links  list  file  wll  be  a  database  containing  information  about  each  link 
created  for  the  system.  Fields  within  this  data  type  will  include  link  name,  link 
number,  time,  author,  pointers  (in  a  format  to  be  determined)  to  each  of  the  linked 
objects,  and  a  pointer  (TBD)  to  a  file  and  text  note  that  contains  additional  text  and 
graphics  pertaining  to  this  link  (if  necessary). 

3.1.5  Notes  List 


The  notes  list  is  a  database  that  will  contain  information  about  each  note 
created  for  the  database.  Fields  within  these  records  will  include  note  name,  note 
number,  time,  author,  attachment  status,  pointer  (format  TBD)  to  attached  object, 
and  pointers  to  attached  files  (if  any)  comprising  the  note. 
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4.0  FUNCTIONAL  DESCRIPTION 


4.1  Basic  Concept  of  Operation 

Consistent  with  general  Windows  application  software,  the  hypertext 
reference  system  will  adopt  the  desktop  metaphor  most  users  will  find  familiar.  In 
addition,  the  familiarity  with  the  interface  should  facilitate  learning  of  the  system. 
The  system  will  present  basic  information  about  a  source  of  adaptive  aiding 
Information:  depth  of  information  sought,  and  guidelines  accessed.  Experiential 
Information  associated  with  a  specific  reference  will  be  available  through  progressive 
disclosure.  This  process  will  be  totally  under  user  control. 

At  the  most  basic  level,  system  furictions  will  be  integrated  through  the  use  of 
the  Windows  desktop.  Users  will  access  the  system  and  different  data  (file)  types 
through  standard  window  operations  within  the  hypertext  development  tool,  the 
development  tool  environment  also  provides  run-time  interface  features;  these 
standard  features  now  become  part  of  the  "system  interface". 

Once  at  the  system  interface,  users  will  be  presented  with  a  standard 
bibliographic  reference  listing  (default  listing).  Users  may  browse  the  reference 
Information,  read  abstracts  and  summaries,  expand  the  bibliographic  information,  or 
list  guidelines  for  a  reference.  Standard  reference  links  allow  the  user  to  peruse  all 
information  extracted  from  a  reference,  browse  the  list  of  guidelines,  and  return  to 
the  reference  directly. 

Other  approaches  to  browsing  the  system  information  are  possible  also.  For 
example,  users  may  only  wish  to  access  information  about  a  specific  design 
question  that  they  have  in  mind.  A  pre-defined  classification  scheme  (see  Anoskey 
and  Andes,  1991;  "Guidelines  for  Adaptive  Aid  Design;  A  Review  of  the  Literature, 
pp.  8-12)  is  available  within  the  system.  Basic  aiding  design  questions  (e.g.,  what 
methods  of  aiding  apply?,  etc.)  are  used  as  classifiers  for  guidelines  ai^  lessons 
learned.  A  user  can  access  the  system  and  address  one  or  more  threads  in  the 
course  of  pursuing  alternative  approaches  to  the  current  design. 

Another  pre-engineered  organization  scheme  will  be  available.  Users  seeking 
information  about  only  human/aid  interaction  or  only  systems  engineering  of  aiding 
systems  will  find  the  alternative  organization  helpful.  This  is  particularly  useful  for 
different  phases  of  design  (i.e.,  software  system  engineering  vs.  user  interface 
design). 

Guide  provides  different  link  types  as  described  in  section  2.1.2.  These 
capabilities  will  be  exploited  within  the  system.  Unk  types,  projected  use  of  links, 
and  navigation  by  link  type  is  described  in  section  5.1. 1.7  "Traversing  Links".  The 
user  may  have  the  guidelines  presented  in  framework  format  (see  previous 
paragraphs)  and  mark/save  only  that  information  pertinent  to  the  specific  design 
issue.  Once  this  process  is  complete,  the  user  may  wish  to  compile  a  listing  of  all 
bibliographic  references  for  the  guidelines  in  the  save  set.  Consistent  with  the  Guide 
run-time  Interface,  the  system  will  support  functions  unique  to  electronic  documents 
including  rapid  information  retrieval  through  query  and  search,  linking,  merging  other 
documents,  etc. 
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4.2  Top-Level  Functions 

Based  on  the  user  analysis  in  this  document  and  our  understanding  of  the 
user  population,  the  system  will  support  five  major  functions: 

1.  Retrieve  information  from  and  navigate  within  the  adaptive  aiding 
reference  and  guidelines  information  base.  This  information  base 
shall  include  the  five  types  of  data  described  in  section  3.0  and  also 
term  definitions,  where  necessary. 

2.  Import  information  and  expand  the  current  information  base  within 
the  guideiines  reference  system.  This  function  will  allow  the  user  to 
add  references  pertinent  to  adaptive  aiding  design,  add  guidelines, 
lessons  learned,  and  summary  objects.  Additionally,  fadlities  will  be 
Implemented  to  allow  the  user  to  add  links  from  guidelines  to 
source,  source  to  summary,  etc.  Special  features  will  allow  the 
linking  of  guidelines  at  a  "conceptual"  level.  Initial  import  of  the  data 
will  be  Logiix  scripted:  Header  information  in  the  material  to  be 
added  to  the  reference  system  will  provide  pre-format  and  Initial 
layout  (either  ‘.DBF  or  ascii-text).  Once  the  pre-format  is  complete, 
it  will  be  up  to  the  author  to  provide  more  robust  linking. 

3.  Annotate  the  information  base  according  to  personal  needs. 
Annotations  shall  consist  of  personal  notes  (section  3.1.5)  about 
information  and  guidelines.  Annotations  will  include  attaching  notes 
to  three  ^pes  of  data  (sections  3.1. 1-3.1. 3)  and  establishing  links 
between  information  instances  for  future  recall. 

4.  Access  utilities  or  objects  external  to  the  reference  system  without 
losing  current  session  instance. 

5.  Manage  the  interface  during  system  operation. 

6.  Save  and  print  specific  information  (e.g.,  references,  guidelines, 
summaries,  etc.)  from  within  the  system.  The  first  prototype  will 
support  only  basic  save  and  print  functions. 


4.3  User  Interaction  Example 

An  example  scenario  Involving  the  use  of  the  tool  to  access  design 
information  is  described  in  this  section.  In  this  scenario,  the  system  user  is  primanly 
concerned  with  a  specific  design  issue.  The  following  narrative  should  provide  a 
better  image  of  user-system  interaction.  All  data,  guidelines,  etc.  are  representative 
of  the  type  of  information  contained  within  the  system. 

Setting 

The  user  is  a  systems  designer  for  advanced  tactical  aircraft  In  the  course  of 
designing  the  pilot  aiding  system,  he  becomes  concerned  vrith  providing  aiding  for 
the  piiot  engaged  in  complex  situation  assessment  and  communication  tasks.  He 
accesses  the  adaptive  aiding  reference  system  with  the  question:  "What  Is  the  best 
method  of  aiding  to  use  when  assisting  the  pilot  engaged  in  a  complex  situation 
assessment/communication  task?" 
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5.0  SPECIFICATION  OF  FUNCTIONS 


5.1  Navigation  and  Infornriatlon  Retrieval 

5.1.1  Browsing 

5. 1.1.1  Designate  file 

The  user  will  designate  a  file  to  browse  (typically  an  alternate  bibliography  file) 
under  the  top-level  file  menu.  There  will  be  three  primary  file  types  to  browse  (they 
will  also  be  symbolically  linked):  bibliography  (section  3.1.1),  guidelines  (section 
3.1.2),  and  summaries  (section  3.1.3).  Other  file/data  ^pes  will  not  be  available 
choices  at  this  level.  The  default  organization  of  the  active  file  will  be  represented 
by  the  outline  displayed  when  the  file  is  ready  to  be  browsed.  Complete  file  format 
will  be  discussed  in  the  detailed  design  document. 

5. 1. 1.2  Expand/collapse  (hierarchical  only) 

Expansion  link  types  within  the  Guide  system  support  expansion  and 
contraction  of  information  (other  tools  support  this  functionality  as  well).  This  type  of 
functionality  will  only  be  present  when  information  about  a  particular 
topic/issue/approach,  etc.  is  arranged  hierarchically.  Anticipated  hierarchical 
amangement  will  involve  depth  of  information  disclosure  on  a  topic. 

The  user  will  activate  this  typ>e  of  function  to  display  additional  headings  or 
text  under  a  main  heading  (e.g.,  design  question  to  be  addressed,  etc.)  in  the 
browse  mode.  The  heading  Is  expanded/collapsed  by  clicking  on  the  hot  item.  The 
shape  of  the  cursor  changes  when  expansion  information  is  available  for  a  topic. 

5.1. 1.3  Scrolling 

Information  windows  and  especially  article  summary  windows  will  support 
mouse/key  activated  scrolling  for  information  that  fills  more  than  one  screen. 

5. 1. 1.4  Alternate  view  selection 

A  "view"  command  will  be  available  at  the  top  level  to  fadlitate  access  to 
alternate  views  of  the  displayed  material  (primarily  guidelines).  View  will  support 
three  modes  (where  appropriate):  Design  framework  view,  default  (TBD)  view,  and 
interaction/adaptation  view.  A  view  mode  indicator  will  show  the  user  what  mode  the 
display  is  currently  in. 

5.1. 1.5  Find  item 

Text  string  or  design  issue  searching  will  be  available  within  the  currently 
active  file.  The  Rnd  command  searches  a  selected  area  of  a  document  for  the 
specified  text.  Rnd  performs  a  local  search  only  beginning  at  the  current  point  in  the 
file  to  the  end. 

The  user  may  employ  the  Rnd  command  in  an  active  hierarchical  outline. 
The  command  will  execute  a  depth-first  search  until  the  first  occurrence  of  the  text  is 
located.  When  located,  the  cursor  is  positioned  at  the  end  of  the  found  search  string 
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and  the  display  is  scrolled  to  that  point  in  the  file.  Only  simple  searching  will  be 
available  in  this  version  of  the  system. 

5. 1.1. 6  Branching 

Users  will  be  provided  with  several  ways  to  jump/branch  from  one  context  to 
another.  This  will  t>9  accomplished  through  the  use  of  different  link  types  (e.g., 
command  links,  reference  links,  etc.).  Branch  operations  wrill  be  "two-way":  Once  the 
user  has  examined  the  hard  link,  a  button  will  return  him  directly  back  from  the  origin 
of  the  branch. 

5. 1. 1. 7  Traversing  links 

A  link  is  a  logical  or  semantic  association  between  two  objects  (reference) 
and  may  be  defined  by  authors  of  the  system,  users,  or  maintainers  of  the  system 
(e.g.,  to  add  new  material).  By  dickino  on  a  hot  link  "button"  the  user  can  activate 
the  linked  object  in  one  action.  Specific  link  types  supported  by  both  the 
development  environment  and  those  that  are  sp^'fically  programmed  for  this 
system  will  be  discussed  in  the  detailed  design  document.  Basic  link  types  provided 
by  the  development  tools  are  described  in  section  2.1.  Unk  types  will  be  employed 
in  the  following  ways  (other  applications  TBD): 

Reference  Links  -  These  links  will  be  used  to  hard  link  the  bibliographic 
reference  to  the  extracted  guidelines,  lessons  learnt,  and  summaries.  They  will  be 
two-way  links  and  current  position  will  be  tracked  via  a  link  traversal  stack. 
Backtr^ing  and  jumping  will  be  supported.  Reference  links  will  also  be  used  to 
connect  related  articles  together  (e.g.,  human  performance  results,  etc.)  and  for 
connecting  guidelines  pertaining  to  a  specific  design  issue  for  which  the  guideline 
applies.  Information  referring  to  a  specific  article  source  will  display  the  reference 
(e.g.,  "Morrison,  et  al.,  1990")  as  a  hot  button  for  dired  access. 

Expansion  Unks  “  Used  to  expand  information  about  a  reference  (e.g. 
abstract,  source  type,  direct  references).  More  In-depth"  information  about  a 
guideline,  for  example,  will  be  hidden  by  expansion  links.  The  user  can  dick  on  the 
term,  etc.  for  more  in-depth  information.  Expansion  links  will  also  be  used  for 
accessing  guideline  rationale  and  lists  of  related  guidelines. 

Note  Links  -  Note  links  will  be  used  to  describe  the  classification  of  a 
guideline  (e.g.,  pertains  primarily  to  "How  to  aid.",  etc.)  and  for  expert  comment  on 
the  material,  rationale,  and/or  reasoning  behind  indusion  of  this  material  in  the 
information  base.  This  type  of  link  will  provide  the  user  with  a  great  deal  of 
background  information.  Term  definitions  will  also  be  referenced  by  note  links. 

Command  Unks  -  These  links  will  be  used  for  activation  of  induded  models 
(rf  any),  access  to  related  graphics  (results  plots,  architecture  block  diagrams,  etc.). 
Compete  furwdionality  TBD. 

Should  the  customer  select  another  hypertext  tool  for  system  implementation, 
fink  types  can  still  be  p>resefved,  albeit  without  system  enforcement  of  link  types. 

5. 1. 1.8  Next,  previous,  first,  last 

These  are  specifically  defined  "go  to"  links  between  system  objects.  They  will 
be  available  throughout  the  system. 
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5.2  User  Annotation 

A  feature  of  this  system  will  be  user  defined  annotations  (via  "notes")  in  the 
Information  base.  Annotations  enhance  the  information  base  by  providing  the  ability 
to  customize  the  information  in  a  problem-  or  user-specific  manner.  Two  types  of 
annotation  will  be  available:  links  and  notes.  Unks  will  be  available  for  establishing 
reJalionships  according  to  all  link  types  available  in  the  system.  Notes  will  allow  the 
user  to  attach  additional  information  to  any  object  in  the  system. 

5.2.1  Unks 

5.2. 1. 1  Create  link  and  add  information  to  links  database 

Users  will  create  links  (this  is  similar  to  the  author  adding  new  material)  by 
selecting  "link"  option  from  the  main  menu.  The  user  will  simply  click  on  the  origin 
material,  access  the  destination  material  with  the  link  commaixl  active,  and  click  on 
the  destination.  When  this  operation  is  complete,  a  dialog  box  will  appear  with 
prompts  for  information  about  the  link.  Once  the  dialog  box  Is  completed,  this 
information  will  be  appended  to  the  links  database  describe  in  section  3.1.4, 

Once  a  link  has  been  created.  It  will  function  similarly  to  other  links  in  the 
system.  The  user  can  activate  the  second  object  by  clicking  on  the  first. 

5.2 1.2  Delete  link 

If  the  user  deddes  to  decouple  two  objects,  the  user  indicates  the  link  and 
selects  delete  from  a  top  level  menu.  Undo  will  be  supported  for  this  function. 

5.2.2  Notes 

5.2.2 1  Create  and  attach  note  to  object 

The  user  will  be  able  to  construct  and  attach  a  note  consisting  of  text, 
(possibly)  graphics,  and  (possibly)  links  at  any  time  during  system  operation. 
Dialogue  boxes  will  walk  the  user  through  the  process  once  "construct  note"  is 
selected  from  the  function  menu.  Once  the  note  is  complete  and  attached,  similar 
information  virill  be  written  to  the  notes  database.  Notes  will  not  be  searchable 
(subject  to  hypertext  tool  capabilities). 

5.22.2  Delete  note  and  identifiers 

The  user  will  be  able  to  delete  notes  and  identifiers  with  one  action.  Undo  will 
be  supported  for  last  operation. 

5.2.3  Bookmarks 


Ideally,  bookmarks  should  be  supported  for  this  type  of  system.  However, 
Guide  does  not  support  such  functionality.  Should  the  customer  dedde  on  a 
cfifferent  development  package,  bookmark  functionality  should  be  specified.  Some 
rudimentary  functionality  of  this  type  may  be  possible  through  scripting. 
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5^  Creates,  Save,  Manage,  and  Integrate  Files 

It  is  assumed  that  the  user  is  familiar  with  DOS  operations  and  basic 
Windows  functionality. 

5.3.1  Open  System 

The  open  command  displays  a  Windows  dialog  box  with  a  listing  of  available 
files  in  the  system.  The  user  can  also  change  drives  or  directories  to  access  files  of 
choice.  Selecting  the  "open"  button  will  activate  the  selected  file. 

5.3.2  Close  System 

The  Close  command  will  close  all  active  windows  associated  with  the  current 
system  and  deactivate  the  run-time  environment  --  back  to  Windows.  If  user 
cnanges  were  made  to  the  file,  the  system  will  prompt  to  save/rename  the  file  before 
dosing. 

5.3.3  Select/Mark  Material  for  Printing 

The  user  can  Print  any  or  all  of  the  records  in  the  currently  active  file.  If  a 
user  defined  organization  was  implemented  or  if  the  file  is  presented  in  alternate 
view  (section  5.1.1 .4),  the  file  will  be  printed  in  that  formal.  Print  options  will  be 
selected  from  a  Windows-based  Print  Options  dialog  box.  Further  print  functions 
based  on  user  defined  searches,  etc.  TBD. 

5.3.4  Import 

The  Import  command  will  be  available  primarily  for  use  with  dBase  or 
formatted  ascii-text  files  of  article  review  information  (e.g.,  bibliography,  guidelines, 
summary).  This  function  is  indigenous  to  most  hypertext  construction  tools.  File 
import  will  accomplished  by  selecting  the  Import  command  from  the  top  level  menu. 
Some  data  seledion  and  formatting  will  be  conducted  via  scripted  reader  functions 
(Import  scripts  looking  for  embedded  formatting  information  in  the  file)  and  through  a 
dialog  box.  Once  the  information  is  read,  it  will  be  up  to  the  author  (user)  to  format 
the  information  and  link  it  with  existing  Information.  Further  information  on 
incorporating  new  material  can  be  found  in  section  5.4  "Edit  files". 

5.3.5  Quit 


The  Quit  command  exits  the  system,  and  returns  the  user  to  the  Wndows 
application  screen.  If  the  user  has  made  changes  to  the  file  without  saving,  a  dialog 
t^x  will  query  the  user  to  save/forget  the  current  file  state. 


5.4  Integrate/Edit  Files 

A  top-level  requirement  for  this  system  is  that  it  be  updatable  by  users.  This 
r^uirement  implies  that  the  user  can  review  new  material  pertaining  to  adaptive  aid 
design,  import  it  into  the  system  and  link  it  to  related  information.  Thus  the  new 
material  would  be  completely  integrated  with  existing  material.  The  following 
fur>ctions  are  specified  for  accomplishing  that  task. 
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5.4.1  integrate  Material/Unks 

This  function  will  be  accomplished  through  the  following  sequence:  The  user 
Imports  a  file  through  one  of  the  previously  specified  methods  (see  section  5.3.4). 

5.4.2  Construct  Unks 


Once  the  material  Is  Imported  Into  the  system,  the  user  can  use  the 
prespecified  types  of  links  (section  5.1. 1.7)  to  integrate  the  new  material  into  the 
system.  For  example,  reference  links  will  be  established  between  the  bibliographic 
reference  and  guidelines  extracted  from  that  reference.  Further,  a  reference  link  will 
be  established  between  the  summary/lessons  learned  text  and  the  bibliographic 
reference. 

Expansion  links  will  be  employed  for  providing  progressive  disclosure  of 
lessons  learned  information,  guideline  rationale,  abstracts,  etc.  Note  links  can  be 
employed  to  disclose  definitions  of  operational  terms,  for  explanation  of  guideline 
wording,  etc.  Should  there  be  any  embeddable  models,  etc.,  commarxJ  links  can  be 
used  to  activate  the  models  while  viewing  the  system. 

The  previous  paragraph  dealt  only  with  linking  of  an  individual  review.  The 
more  difficult  task  with  incorporating  new  material  is  conceptual  linking  with  existing 
material.  This  requires  knowledge  of  the  classification  framework,  adaptive  aiding 
technology,  and  system  architecture.  Specific  Information  pertaining  to  integration 
practices  will  be  covered  in  the  detailed  design  document. 


5.5  User  Interface  Management  Functions 

The  system  will  adhere  to  the  Windows  interface  design  standard  to  the 
extent  possible. 

5.5.1  Wndow  Management 

Wndows  are  opened  according  to  actions  performed  by  the  user.  Clicking  on 
an  icon,  button,  or  menu  Item  are  operations  that  result  In  opening  or  closing 
windows.  A  window  can  contain  any  type  of  information  (e.g.,  explanation  - 
expansion,  annotation  -  note,  etc.).  Most  windows  can  be  moved,  scrolled,  sized, 
and  closed.  These  functions  will  be  accomplished  through  standard  Windows 
operations.  Wirxjows  may  be  tiled  or  overlapped. 

5.5.2  Material  Views 


As  stated  in  section  5.1. 1.4,  different  views  (organization)  of  the  information 
may  be  accessed  by  the  user.  Depending  on  the  view  desired  (e.g.,  design  Issue, 
Interface  vs.  software)  the  information  will  be  rearranged  to  reflect  that  organization. 
Alternate  views  will  be  selected  by  mouse-clicking  the  appropriate  top-level  menu 
Item.  When  an  alternative  view  is  selected,  the  user  remains  at  the  same  place  as 
before  the  selection.  An  icon  in  the  lower  right  comer  of  the  active  window  Indicates 
selected  view. 
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6.0  PROGRAM  PLAN 

In  this  section,  basic  tasks  and  time  estimates  for  implementation  are  given. 
Time  estimates  are  based  on  months  after  contract  (MAC).  Staff  estimates  are  in 
number  of  full-time  equivalents  (FTE). 


Task 

Timeframe 

Staff 

Revise  System  Requirements  Document 

1  MAC 

1  FTE 

Produce  Detailed  Design  Document 

2.5  MAC 

1  FTE 

Information  Format  Engineering 

4.5  MAC 

2  FTE 

Review  Other  Relevant  Material 

7  MAC 

1-2  FTE 

Produce  Prototype 

10  MAC 

2  FTE 

Test  Prototype 

11  MAC 

.25  FTE 

Construct  User's  Manual 

13  MAC 

1  FTE 
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7i)  SUMMARY 

A  preliminary  approach  to  a  hypertext-based  reference  system  for  adaptive 
aiding  design  information  has  been  specified.  This  system  wll  provide  a  repository 
for  information  pertaining  to  the  understanding,  design,  and  empirical  validation  of 
aiding  system  designs.  The  system  specification  capitalizes  on  the  already  reviewed 
and  summarized  Information  developed  under  the  AFAIC  program.  Data  types, 
Input/output,  and  browsing  of  the  material  were  addressed  with  particular  emphasis 
placed  on  the  extensibility  of  the  system.  Given  the  current  level  of  information 
collected  under  the  literature  review  process  (Anoskey  and  Andes,  1991)  an 
evaluation  prototype  of  the  system  can  be  constructed  in  a  straightforward  manner. 

An  extensive  review  of  the  projected  user  population  was  given.  The  user 
population  will  engage  in  different  Information  seeking  behaviors,  spedfically,  they 
will  seek  specific  guidance  on  a  design  question  or  look  for  missing  information 
about  how  to  approach  a  design  problem.  All  of  these  behaviors  should  be 
supported  within  the  current  specification. 

AHernative  software  and  hardware  platforms  were  reviewed  based  on  several 
selection  criteria  (e.g.,  price,  portability,  software  functionality,  etc.).  The 
recommended  platform  for  the  hypertext  system  is  a  PC-386  class  machine  using 
the  Guide  Hypertext  software  package  running  under  Windows  3.0.  Several  reasons 
for  this  choice  were  given.  Other  alternatives  are  available.  Details  of  system 
functions  were  specified  with  particular  attention  paid  to  concept  of  operations  and 
system  capabilities  past  initial  prototype.  Rnally,  a  rough  design  and  implementation 
schedule  was  given. 
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